The Controls Element

The Controls element within the FrameworkSettings element contains properties for various AssetWise controls.

      <Controls>
        <CustomisablePropertiesContainer alwaysEnforceRequiredAttributes="false" hideEmptyProperties="true" />
        <ErrorControl showPopup="false" />
        <LayoutProvider mappingUrl="http://maps.google.com/maps?f=q&amp;hl=en&amp;geocode=&amp;q={0}" />
        <CustomisableRelationshipsContainer hideEmptyRelationships="true" />
      </Controls>

<CustomisablePropertiesContainer>

The CustomisablePropertiesContainer element defines some options used when displaying or editing properties of objects from layouts.

Attribute	Value	Description
alwaysEnforceRequiredAttributes	true or false	If set to true, an edit properties control forces the user to supply all of the required properties of the object as defined by the layout.
hideEmptyProperties	true or false	If set to true, a display properties control hides properties that have no value assigned to them. If set to false, the control includes empty properties when rendering the display.

<ErrorControl>

The ErrorControl element lets you control whether users can access extra information about an error generated by AssetWise. It is recommended that this setting be left set to false.

Attribute	Value	Description
showPopup	true or false	Used to determine whether or not the error control should emit code that contains an exception's call stack. You may be asked to enable this by Bentley support.

<LayoutProvider>

The LayoutProvider element defines some options used when displaying properties of directory entries.

Attribute	Value	Description
mappingUrl	a URL (required)	Specifies the URL of the web site that physical address directory entries link to. The URL should contain the characters `{0}` (a zero between two curly braces) in the position where the URL expects the address to be. Leave this attribute empty if you do not want to use this feature.
mailUrl	a URL (required)	Specifies the URL of the web address that email address directory entries link to. The URL should contain the characters `{0}` (a zero between two curly braces) in the position where the URL expects the email address to be. Leave this attribute empty if you do not want to use this feature.
voipUrl	a URL (required)	Specifies the URL of the web address that telephone number directory entries link to. The URL should contain the characters `{0}` (a zero between two curly braces) in the position where the URL expects the phone number to be. Leave this attribute empty if you do not want to use this feature.

<CustomisableRelationshipsContainer>

The CustomisableRelationshipsContainer defines some options used when displaying relationships of objects in layouts.

Attribute	Value	Description
hideEmptyRelationships	true or false	If set to true, a display relationships control hides relationships that have no members assigned to them. If set to false, the control includes empty relationships when rendering the display.